Retrieves the filename and parent directory ID of the file with a specified file ID.

OSErr PBResolveFileIDRefAsync (
    HParmBlkPtr paramBlock
);

paramBlock

A pointer to an fidParam variant of the HFS parameter block.

function result

A result code.

DISCUSSION

The relevant fields of the parameter block are:

• ioCompletion

  On input, a pointer to a completion function.

• ioResult

  On output, the result code of the function. A return code of fidNotFoundErr means that the specified file ID reference has become invalid, either because the file was deleted or because the file ID reference was destroyed by PBDeleteFileIDRefAsync.

• ioNamePtr

  A pointer to a pathname. On output, the function returns the filename in the string pointed to in this field. If the name string is NULL, PBResolveFileIDRefAsync returns only the parent directory ID. If the name string is not NULL but is only a volume name, PBResolveFileIDRefAsync ignores the value in the ioVRefNum field, uses the volume name instead, and overwrites the name string with the filename.

• ioVRefNum

  On input, a volume specification.

• ioSrcDirID

  On output, the file’s parent directory ID.

• ioFileID

  On input, a file ID for the file to retrieve information about.

AVAILABILITY

Supported in Carbon. Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.

© 2000 Apple Computer, Inc. — (Last Updated 5/8/2000)